Release Management/Release Process Checklist Documentation
The goal of this page is to document the Release Process Checklist being used by Firefox Release Managers to track each release throughout the cycle. Any changes to this documentation or the checklist should be reflected in both documents.
Contents
- 1 Nightly Checklist
- 1.1 Prior to the start of the Nightly cycle, the following tasks need to be performed before Merge Day
- 1.2 At the start of the Nightly cycle, the following tasks need to be performed on Merge Day
- 1.3 On a daily (or thereabouts) basis, the following items should be monitored during the Nightly cycle
- 1.4 On a weekly (or thereabouts) basis, the following items should be monitored during the Nightly cycle
- 1.5 As available, the following items should be monitored during the Nightly cycle
- 1.6 At the end of the Nightly cycle, the following tasks need to be performed prior to and during Merge Day
- 2 Beta Checklist
- 2.1 The following tasks need to be performed on Merge Day at the start of the Beta cycle after the merge to beta is finished
- 2.2 The following tasks need to be performed daily during the Beta cycle
- 2.3 The following tasks need to be performed for each beta build (Monday, Wednesday, Friday) during the Beta cycle
- 2.4 As available, the following items should be monitored during the Beta cycle
- 2.5 The following needs to be performed at the End of Early Beta
- 2.6 The following needs to be performed at the end of the Beta Cycle
- 3 RC Checklist
- 3.1 The following tasks need to be performed at the start of RC week (week before go-live) for Desktop/Android
- 3.2 The following tasks need to be performed at the start of RC week (week before go-live) for iOS
- 3.3 As available, the following should be monitored/performed during RC week for Desktop/Android
- 3.4 As available, the following should be monitored/performed during RC week for iOS
- 4 RC Uplifts
- 5 Go-Live Checklist
- 5.1 The following tasks need to be performed prior to go-live
- 5.2 The following tasks need to be performed on go-live day
- 5.3 The following tasks need to be performed 24 hours after go-live
- 5.4 The following tasks need to be performed 48 hours after go-live
- 5.5 The following tasks need to be performed daily after go-live
- 5.6 The following tasks need to be weekly after go-live
- 6 Dot Release Uplifts
- 7 Dot Release Checklist
- 7.1 The following tasks need to be performed at the start of preparing a dot release
- 7.2 The following tasks need to be performed during go-live of a dot release
- 7.3 The following tasks need to be performed 24 hours after go-live of a dot release
- 7.4 The following tasks need to be performed daily after go-live of a dot release
Nightly Checklist
Given the nature of how nightly builds are created and shipped, the role of the release manager during this phase of the cycle skews much more heavily to the monitoring aspect rather than release mechanics.
Prior to the start of the Nightly cycle, the following tasks need to be performed before Merge Day
- Create a Release Checklist before the cycle starts.
- Use the template from Google Drive.
- Create the Milestones Document for the Release Checklist.
- Use the sheet linked in the Release Checklist.
- Create a Firefox Retrospective Notes document.
- Use the template from Google drive.
- It is useful to document during the release cycle.
- Create a folder in the Release Tracking Google Drive for the release.
- Move the Release Checklist and Firefox Retrospective Notes to this folder.
- Create a release notes skeleton in Nucleus.
- Click Admin Interface
- Click the Releases.
- Select the previous Nightly release notes (enable the checkbox beside the release).
- At the top of the page, expand the Action dropdown
- Select Copy releases.
- Click Go.
- Select the copy.
- In the Version text box edit the version to the current Nightly version.
- Example: 99.0a1
- Set the Release Date to match when Central was bumped to Nightly
- Remove the release notes from the previous release.
- For additional information on the Release Notes process see The Firefox release notes process wiki page.
- Ensure that Bugzilla is bumped to the Nightly version, see BMO/new-version
- Note: This is performed on the Friday before Merge Day.
- Find the bug that tracks the bump.
- Update the Release Milestones in Bugzilla
- Got to https://bugzilla.mozilla.org/admin/new_release
- The products and milesontes are automatically completed
- Click [ Submit ]
- Update the Release Tracking flags in Bugzilla
- Go to Bugzilla > Administration > Release Tracking Flags
- Add the cf_tracking_firefox and cf_status_firefox for the Nightly release
- Example: If 97 is becoming the Nightly, then add cf_tracking_firefox97 and cf_status_firefox97.
- Deactivate the oldest cf_tracking_firefox flag.
- Example: If 95 is going to Release, 96 is going to Beta, and 97 is becoming the Nightly, then deactivate cf_status_firefox94.
- Edit the current cf_tracking_firefox_esr tracking flag to add the new release as a Value and deactivate the oldest release.
- Example: If esr is based on 91, 95 is going to Release, 96 is going to Beta, and 97 is becoming the Nightly, then edit cf_tracking_firefox_esr91 to add a Value 97+ set to mozilla-next-drivers and deactivate the Value 94+
- Add the cf_tracking_thunderbird and cf_tracking_thunderbird for the Nightly release.
- Example: If 97 is becoming the Nightly, then add cf_tracking_thunderbird97 and cf_tracking_thunderbird97
- Deactivate the oldest cf_tracking_thunderbird flag.
- Example: If 95 is going to Release, 96 is going to Beta, and 97 is becoming the Nightly, then deactivate cf_tracking_thunderbird94.
- Edit the current cf_tracking_thunderbird_esr tracking flag to add the new release as a Value and deactivate the oldest release.
- Example: If esr is based on 91, 95 is going to Release, 96 is going to Beta, and 97 is becoming the Nightly, then edit cf_tracking_firefox_esr91 to add a Value 97+ set to mozilla-next-drivers and deactivate the Value 94+.
- Add a comment on the bug that the tracking flags were updated.
- See comment here for example.
- Update the Google calendar Releases Scheduling.
- Open the following URL and change the version to the Nightly release.
- Download the generated ical file.
- Review locally on a calendar app of your choice
- Open Google Calendar.
- Click + beside Other Calendars.
- Select Import.
- Select the ical file previously downloaded.
- Select the Releases Scheduling calendar.
- Click Import.
- Please Note: Importing the ical to Google Calendar is a one-shot operation. If you notice incorrect info or dates after importing, correct them directly in Google Calendar. Importing the ical file again will cause duplication.
- Ensure the REO (Regression Engineering Owner) is listed on Release Owners.
- If required check the Google Sheet REO Rotation by Director.
- Update the wiki with information from the spreadsheet.
- Ensure that the REO and RelEng owners are listed.
- Ensure the dates are accurate.
- If required reach out to the Director to find out who the REO is.
- Ensure they are invited to the Weekly Regression Triage.
- Ensure the Release Engineer on Release Duty is listed on Release Owners.
- If required reach out on Matrix #releaseduty.
At the start of the Nightly cycle, the following tasks need to be performed on Merge Day
- Verify that Central was bumped to the Nightly version.
- Check version_display.txt
- Please Note: This is performed on Merge Day of the release going to beta, if it is incorrect talk to the RelMan on duty for the Beta cycle.
- Verify that the firefox-android version was updated.
- Chheck version.txt should be xxx.0a1, where xxx matches the nightly version of desktop.
- If the version was not updated, then sync with release engineering.
- Make the release notes public in Nucleus
- Verify the application services version was updated
- The version in version.txt should be xxx.0a1, where xxx matches the nightly version of desktop.
- If the version was not updated then talk to the RelMan on duty for the Beta cycle.
- Verify the firefox_versions.json is correct.
- Please Note: Usually this json update is performed the day after merge day
- Please Note: fx trains and various scripts in other tools use this data.
- Verify the following are correct:
- FIREFOX_NIGHTLY, NEXT_MERGE_DATE, NEXT_SOFTFREEZE_DATE
- If these are incorrect, contact the RelEng on duty via the #release-duty channel in Matrix. It is possible a PR was missed during the RelEng merge day steps.
- Please Note: There are also date changes that are monitored by autonag. For example, if Template:NextReleaseDate was not updated an autonag email will be sent.
- Verify the mobile_versions.json is correct
- Verify the following are correct:
- alpha_version, nightly_version
- If these are incorrect, contact the RelEng on duty via the #release-duty channel in Matrix.
- Verify the following are correct:
On a daily (or thereabouts) basis, the following items should be monitored during the Nightly cycle
- Review Pending tracking-firefoxXX requests
- Example Filter
- Ensure that the tickets are progressing, follow up as required.
- Review Open tracking-firefoxXX+ and blocking bugs
- Example Filter
- Ensure that the tickets are progressing, follow up as required.
- Review incoming regression bugs
- Example Filter
- Also see the REO section in the BugDash
- Ensure that new tickets are prioritized.
- Ensure that carry-over tickets are still on the team’s radar.
- Review with the REO in the weekly regression meeting.
- Review stability rates and reported crash spikes
- Leverage information from the automated emails, monitor top crashes in Crash Stats, and monitor Stability & Release Monitoring Looker Dashboard
- Ensure that there are bugs tracking stability rates and crash spikes.
- Ensure these tickets are tracked and prioritized.
- Please Note: If ever there are stats/bugs that cannot be explained/identified, then reach out to the team for assistance on the #stability Matrix channel, it may be an issue with the tooling issue.
- Review the Release Notes requests for Nightly Tickets.
- See Release_Notes#Daily_during_the_Nightly_cycle for details.
On a weekly (or thereabouts) basis, the following items should be monitored during the Nightly cycle
- Review the tracking Mana page for the release.
- The tracking page can be found as a child of Firefox Release Tracking
- Ensure that features targeting the release are on track, reach out as needed if any are slipping.
- Update the Weekly Release Tracking Digest document, as requested on #fx-weekly-digest.
- Update the Release Milestones (Details) section to add Status (On Track, Delayed), Ship Date, and additional details depending on where the nightly is in the cycle for example coming up to the Soft Freeze.
- Review the dates in the Release Milestones section and update the status.
As available, the following items should be monitored during the Nightly cycle
- Review and land mozilla-central repo-update HSTS HPKP remote-settings tld-suffixes patches.
- Every Monday and Thursday revisions are automatically created for review in Phabricator.
- Monitor email notifications sent by Phabricator: “No Bug, mozilla-central repo-update HSTS HPKP remote-settings tld-suffixes”
- Review and land the patch to autoland.
- Review and land android nightly application-services version update bumps to mozilla-central
- An automated nightly application-services build is triggered daily. The build will only run if commits merged to main since the previous nightly build.
- update-bot creates a patch to bump the version for android in mozilla-central, runs a Try build, and sets the release-mangers group as reviewer.
- Monitor email notifications sent by Phabricator: Update android nightly application-services version bump
- Review and land the patch to autoland.
- If the Try build failed:
- Check the failure.
- Check the possible commit in application-services main that corresponds to the failure.
- Start a thread on #application-services-eng for investigation.
- Review Test Plans for features targeting the release. QA shares test plans via email. For example:
- Become familiar with how the feature works.
- Understand how the team ensures it is of sufficient quality to ship in that release.
- Provide feedback on the risk analysis and mitigations put in place.
- Review mid-Nightly and pre-Beta testing reports QA shares mid-Nightly and pre-Beta testing reports via email. For example:
- If there are any red or yellow reports review the recommendations/plan and the bugs mentioned in the report.
- If QA flagged that the feature is behind a pref verify that this is expected.
At the end of the Nightly cycle, the following tasks need to be performed prior to and during Merge Day
- Send Nightly Soft Code Freeze reminder to dev-platform and firefox-dev.
- Send this at the start of the week before the Soft Code Freeze.
- Remind developers that the window for landing riskier fixes is coming to a close until after the version bump.
- Example email
- Sync with RelEng to confirm the RelEng on duty for the Central to Beta merge.
- Sync on Friday before Merge Day
- Use the #releaseduty channel on Matrix.
- Align to perform the merge early on Merge Day, for example, 9/10am ET.
- Sync with the Sheriff team to confirm Central is in a good state so that the Merge Day email can be sent.
- Sync on Merge Day morning
- Use the #sheriffs channel on Matrix.
- Check the Beta simulations document for the release, this document is emailed to Release Management at the start of the night cycle.
- Ensure that central does not currently have any known severe regressions or performance issues that would be carried into beta.
- Once you have confirmed central is in a good state, send the Merge Day email to release-drivers and release signoff
- Example email for the merge day of 103:
- Sync with RelEng on the Central to Beta merge
- Use the #releaseduty channel on Matrix to mention the merge day email was sent
- Sync with the RelEng on duty. The RelEng on duty is listed in the Matrix channel description
- Create a Desktop Beta Checklist and Mobile Beta Checklist for beta 1
- Use the b1 macro
- Wait for RelEng to complete the central to beta merge.
- Use the #releaseduty channel on Matrix to synchronize if needed.
- RelEng will also reply to the Merge Day email
- Prepare the Beta release notes in Nucleus
- Click Admin Interface
- Click the Releases
- Select the Nightly release notes (enable the checkbox beside the release)
- At the top of the page, expand the Action dropdown
- Select Copy release
- Click Go
- In the Channel dropdown select Beta
- In the Version text box edit the version to the Beta version
- Example: 96.0beta
- Replace the content in the Text box with content from a previous beta release
- Set the Release Date to the date when the first Beta is released
- Ensure to remove any notes that are only applicable to nightly
Beta Checklist
Once a release moves to the Beta cycle, the daily tasks performed during the Nightly cycle will continue to be carried out as new bug reports come in from a wider audience and new features move through the QA cycle towards shipping. There is also an added triage step during Beta - monitoring the “missed uplifts” email or queries to find issues fixed in Nightly that still affect Beta.
The following tasks need to be performed on Merge Day at the start of the Beta cycle after the merge to beta is finished
- Perform the release management steps in the App Services Release checklist
- Application Services release once and at the start of the beta cycle.
- This step is required before building Android/iOS.
- Switch to Application Services in Firefox Android to Release
- Change the Version and Channel in mobile/android/android-components/plugins/dependencies/src/main/java/ApplicationServices.kt
- See example commit
- Push directly mozilla-beta
- Change the Version and Channel in mobile/android/android-components/plugins/dependencies/src/main/java/ApplicationServices.kt
- Perform the release management steps in the Firefox iOS Soft Freeze Checklist
- The Firefox iOS release branch is used for beta and rc builds.
- Announce the soft freeze is over
- Reply back to the soft code freeze announcement email
- "The version bump to xxx has now landed on mozilla-central and the soft freeze period is over."
- Review any pending uplifts that may be required before proceeding with a beta 1 build
- This should not be a common occurrence, however, an example would be a crash fix that may have landed in central post-merge.
- Set up Desktop and DevEdition builds in Ship-It
- Connect to the VPN
- Log into Ship-It
- Click Releases dropdown
- Click Firefox dropdown
- Click New
- For Desktop complete as follows and click Create Release:
- Please note: Revision should be the tip. The Partial updates field is automatic.
- For DevEdition complete as follows and click Create Release
- Please note: Revision should be the tip. The Partial updates field is automatic.
- Start the Desktop and DevEdition in Ship-it via the Promote Task
- View the Pending Releases in Ship-It
- Click the Promote Task for Desktop and continue through the pop-ups
- Click the Promote Task for DevEditon and continue through the pop-ups
- Confirm the Desktop and DevEdition builds have started
- Taskcluster email: “[desktop] Build of firefox xxx.0b1 build 1”
- Taskcluster email: “[desktop] Build of devedition xxx.0b1 build 1”
- Confirm notification sent when the Desktop and DevEdition builds finish
- Taskcluser email: “firefox xxx.0b1 build1/mozilla-beta is in the candidates directory”
- Taskcluser email: “devedition xxx.0b1 build1/mozilla-beta is in the candidates directory”
- Schedule push to Desktop and DevEditon CDN from Ship-It via Push
- Click Push
- Click Schedule
- Click Push
- Confirm notification sent when the Desktop and DevEditon CDN push finishes
- Taskcluser email: “firefox xxx.0b1 build1/mozilla-beta has been pushed to cdntest”
- Taskcluser email: “devedition xxx.0b1 build1/mozilla-beta has been pushed to cdntest”
- Create Firefox Android (AC, Fenix, Focus) release in Ship-It
- Start Firefox Android (AC, Fenix, Focus) release in Ship-It via Promote
- Please note: you can only start a ship-it build on a revision that has a completed decision task
- Confirm notification sent when the Firefox Android (AC, Fenix, Focus) builds finish
- Taskcluster email: “firefox-android XXX.0b# build1/mozilla-beta is in the candidates directory"
- Push Firefox Android (AC, Fenix, Focus) release in Ship-It via Push
- Monitor for QA sign-off on desktop functional testing, before proceeding with Step 17.
- Please Note: Desktop Build Validation sign-off is usually provided the day after Merge Day.
- QA will post a message to the #qa-coordination channel in Slack when they complete functional testing.
- Build validation testing is tracked here
- Once QA has signed off, push Desktop and DevEdition to Beta in Ship-It via Ship.
- Verify that the Balrog rule changes are live and correctly set.
- View the Balrog Rules for Firefox Beta
- Verify that the Background rate for Firefox-xxx.0b1-build1 is 25
- View the Balrog Rules for Aurora (DevEdition)
- Verify that the Background rate for Devedition-xxx.0b1-build1 is 100
- View the Balrog Rules for Firefox Beta
- Activate automated betas in Ship-It
- At the bottom of the page, click the red x beside Firefox Desktop: Beta
- Click Enable
- Perform the same actions for Firefox Developer Edition: Beta and Firefox Android (Android-Components, Fenix, Focus): Beta
- Please Note: Automated Betas are built at 13:00 UTC every Monday, Wednesday, and Friday as determined here.
- At the bottom of the page, click the red x beside Firefox Desktop: Beta
- Make the Beta release notes public in Nucleus
- Enable the Is Public checkbox and save
- Enable the Is Public checkbox and save
- Share a link to the Beta release notes and the release notes draft document in #release-notes Slack channel
- See example
- Email release-notes with a link to the draft document and the submission deadline.
- See example
- Monitor for QA sign-off on desktop update testing
- QA will post a message to the #qa-coordination channel in Slack when they complete update testing.
- Monitor for QA sign-off on Fenix/Focus build validation
- Fenix build validation testing is tracked here
- Focus build validation testing is tracked here
- Please Note: Build Validation sign-off is usually provided the day after Fenix/Focus builds are produced.
- Focus and Fenix QA sign-off are sent via #qa-coordination Slack Channel
- Once QA has signed off, roll out Fenix to the production track at 25% in Google Play
- Once QA has signed off, roll out Focus to the Closed testing - Foxfooding track at 25% in Google Play
- Monitor for QA sign-off on Firefox iOS build validation
- Build validation testing is tracked here
- Once QA has signed off, add the External Beta Testers group to the Firefox iOS TestFlight Build
- Monitor for QA sign-off on Focus iOS build validation
- Build validation testing is tracked here
- Verify the mobile_versions.json is correct
- Verify the following beta_version is correct:
- If this is incorrect, contact the RelEng on duty via the #release-duty channel in Matrix.
The following tasks need to be performed daily during the Beta cycle
- Monitor Uplift Requests
- Example Filter and Phabricator Dashboard
- Accept or reject the beta uplift requests.
- See Uplift Rules for guidelines
- Please Note: During the RC week, also monitor release uplift requests.
- Please Note: When pushing uplifts be conscious of timing around the automated beta builds. Pushing an uplift will trigger CI, the automated beta build will not trigger until the CI completes.
- Please Note: If an uplift contains string changes, then l10n approval is required and the commit message must end with l10n=approver_name. Add a ni on the bug for approval before taking the uplift.
- Monitor Pending tracking-firefoxXX requests
- Example Filter
- Ensure that the tickets are progressing, and follow up as required.
- Monitor Open tracking-firefoxXX+ and blocking bugs
- Example Filter
- Ensure that the tickets are progressing, and follow up as required.
- Monitor Newly-filed regression bugs
- New regressions bugs can be found here
- Review with the REO - ensure that new tickets are prioritized and ensure that carry-over tickets are still on the team’s radar
- Monitor stability rates and reported crash spikes
- Leverage the automated emails, monitor top crashes in crash-stats, and monitor Stability & Release Monitoring
- Ensure that there are tickets tracking issues with stability rates and crash spikes
- Monitor the Release Notes requests for Beta Tickets.
- Example Filter
- Check through tickets in the release that are tagged for release notes. Review and add these notes to the Beta Release Notes in Nucleus.
The following tasks need to be performed for each beta build (Monday, Wednesday, Friday) during the Beta cycle
Please Note: The Beta build pipeline is also monitored by the Sheriffs, if there is an intermittent test failure they will rerun the failed job. If there is a permanent failure or an issue in the build infrastructure, then it may require canceling the build. Discuss in the #releaseduty Matrix channel. If the decision is made to cancel, then view the pending release in ship-it and click cancel. To create a new build, follow the same steps as outlined in One Time - Start of Beta Cycle to produce build 2 of the current beta release.
- Create a tab in the release tracking sheet “xxx.0bx”
- Use the relevant beta macro
- Please note: After all the beta steps are complete, the tab can be hidden in order to minimize clutter.
- Review tracking-firefoxXX+ bugs and approval requests.
- This step is performed as part of the daily activities, tracked in the checklist for confirmation.
- Verify all approved bugs landed on mozilla-beta.
- This step is performed as part of the daily activities, tracked in the checklist for confirmation.
- Ensure the Firefox iOS build is available in Testflight
- Firefox Beta TestFlight
- If the build is not pushed then check the build status in the BitRise pipeline
- Confirm the Desktop and DevEdition builds have started.
- Taskcluster email: “[desktop] Build of firefox xx.0bx build 1”
- Taskcluster email: “[desktop] Build of devedition xx.0bx build 1”
- Please Note: The automated beta builds schedule is determined here.
- Confirm notification sent when the Desktop and DevEdition builds finish.
- Taskcluster email: “firefox xx.0bx build1/mozilla-beta is in the candidates directory”
- Taskcluster email: “devedition xx.0bx build1/mozilla-beta is in the candidates directory”
- Confirm the Firefox Android (AC, Fenix, Focus) builds have started
- Taskcluster email: “Build of firefox-android xx.0bx build 1"
- Confirm notification sent when the Firefox Android (AC, Fenix, Focus) builds finish
- Taskcluster email: “firefox-android xx.0bx build1/mozilla-beta is in the candidates directory"
- Push Firefox Android (AC, Fenix, Focus) release in Ship-It via Push
- Confirm notification sent when the Firefox Android (AC, Fenix, Focus) push finishes
- Focus/Fenix XXXb#-build1 has been pushed to the closed testing track on Google Play
- Ship Firefox Android (AC, Fenix, Focus) from Ship-It via Ship
- Promote Fenix to the Production track @ 50% b2 and @ 99% b3+
- Promote Android Focus to the closed testing track (Foxfooding) @ 50% b2 and @ 99% b3+
- Confirm notification sent when the Desktop and DevEditon CDN push finishes.
- Taskcluster email: “firefox xx.0bx build1/mozilla-beta has been pushed to cdntest”
- Taskcluster email: “devedition xx.0bx build1/mozilla-beta has been pushed to cdntest”
- Verify that the Desktop and DevEdition Balrog rule changes are live and correctly set.
- View the Balrog Rules for Firefox Beta
- Verify that the Background rate for Firefox-xx.0bx-build1 is:
- 50 for Beta 2
- 100 for Beta 3 and greater
- View the Balrog Rules for Aurora (DevEdition)
- Verify that the Background rate for Devedition-xx.0b1-buildx is 100.
- View the Balrog Rules for Firefox Beta
- Monitor for QA sign-off on Desktop and DevEdition build validation for both update/functional testing.
- QA will post a message to the #qa-coordination channel in Slack when they complete update testing and another message when they complete functional testing.
- Build validation testing is tracked here
- Monitor for QA sign-off on Fenix/Focus build validation before proceeding with bumping the Fenix/Focus rollout.
- Focus and Fenix QA sign-off are sent via #qa-coordination Slack Channel.
- Please Note: Build Validation sign-off is usually provided the day after Fenix/Focus builds are produced. If the sign-off is yellow/red, then follow-up on the #mobile-android-team Slack channel. Ensure a plan is in place or a decision is made to block/proceed with the release.
- For b3+ once QA has signed off, roll out Fenix to the production track in Google Play to 100%.
- Reply to the QA sign-off Slack message and include the rollout percentage.
- For b3+, once QA has signed off, roll out Focus to the Closed testing - Foxfooding track in Google Play to 100%.
- Reply to the QA sign-off Slack message and include the rollout percentage.
- Monitor for QA sign-off on Firefox iOS build validation before proceeding with adding the External Testers group in TestFlight.
- Firefox iOS QA sign-off are sent via #qa-coordination Slack Channel.
- Please Note: Build Validation sign-off is usually provided the day after Firefox iOS builds are produced. If the sign-off is yellow/red, then follow-up on the #firefox-ios-releases Slack channel. Ensure a plan is in place or a decision is made to block/proceed with the release.
- Once QA has signed off add the External Testers group to Firefox iOS.
- Reply to the QA sign-off Slack message.
As available, the following items should be monitored during the Beta cycle
- QA shares beta testing and pre-release testing reports via email. Review the test reports for the release. For example:
- If there are any red or yellow reports, review the recommendations/plan and the bugs mentioned in the report. For example:
- Track the bug reported as blockers.
- If there is no clear plan to address the report, follow up to ensure that engineering is reviewing.
- If QA mentions the feature is behind a pref verify that this is expected.
- If there are any red or yellow reports, review the recommendations/plan and the bugs mentioned in the report. For example:
- Phabricator patches for remote-settings updates are generated automatically. Typically this is every Monday and Thursday. These patches must be included in the beta uplifts.
- Monitor email notifications sent by Phabricator: “No Bug, mozilla-beta repo-update HSTS HPKP remote-settings tld-suffixes”
- Review the patch.
- Commit the patch to beta via the moz-phab tool
- moz-phab patch <patch id> --no-bookmark --apply-to here
- Edit the commit message to add the approval.
- Use the Mana Beta Quality Metrics Page to review the Beta Quality Metrics.
- The data is embedded from this wiki page.
- The data is currently added manually.
- The data is stored automatically every day in bugzilla using New Charts
- To extract the data, run the report by adding the next needed dates and then exporting to csv. (The queries are numbered to make this step easier)
- This is then manually pasted into the 'Data from Queries' tab.
- Please Note: the goal is to automate this.
- Take a look at the metric/charts over time to ensure the value is stable.
- Please Note: Ensure the data is updated prior to the Tuesday channel meeting.
- Update the Weekly Digest document, as requested on the #fx-weekly-digest Slack channel.
- Update the Release Milestones (Details) section to add Status (On Track, Delayed), Ship Date, information on the current beta release for both Desktop/DeveEdition and Fenix/Focus, information on where we are in the Beta cycle for example when coming up to end of early beta.
- Review the Release Milestones section dates and update the status.
- Update the Quality Metrics section to add information on the number of outstanding regressions, if there are any release blockers, and an overview on the trend of the Beta Quality Metrics metrics.
The following needs to be performed at the End of Early Beta
Please Note: This is performed on the Friday at the midday point of the beta cycle, see the Releases Scheduling google calendar. This is typically after beta 6 has been released. This should be done in its own push and before pushing any other uplifts to beta.
- Open build/defines.sh
- Clear the EARLY_BETA_OR_EARLIER flag:
- EARLY_BETA_OR_EARLIER=1 to EARLY_BETA_OR_EARLIER=
- Commit the changes:
- hg commit -m "No bug - post beta 6, unset EARLY_BETA_OR_EARLIER. a=me"
- Push the changes to beta.
The following needs to be performed at the end of the Beta Cycle
- Disable automated beta builds in Ship-it.
- Disable the firefox-ios firefox-ios SPM_Deploy_Prod_Beta BitRise scheduled workflow.
- Expand the Scheduled section in the firefox-ios on BitRise
- Pause the schedule for the SPM_Deploy_Prod_Beta that runs "Every Tue, Thu, Sun @ 20:00"
- Please Note: Monitor beta/release uplift requests between the final beta build and the beta to release merge. It is possible that a late uplift request may come in for a regression/stability fix, evaluate if this is a blocker for the RC and if it should be uplifted to beta before the beta to release merge and RC build.
RC Checklist
Once a release moves to the Release cycle, preparations for the release candidates begin. Until go-live, the daily tasks are similar to the beta cycle in terms of monitoring and if needed create a new release candidate.
The following tasks need to be performed at the start of RC week (week before go-live) for Desktop/Android
- Review tracking-firefoxXXX+ bugs and approval requests
- Verify that all approved uplift requests were uplifted to beta
- Verify all approved bugs landed on mozilla-release
- Sync with RelEng to merge Beta to Release.
- Send an email with details of the merge.
- Include both release-drivers and release sign-off
- Example email
- Sync with RelEng to merge Beta to Release.
- Once the merge is complete, verify that the Treeherder tests green/starred
- Set up Desktop build in Ship-It.
- Connect to the VPN.
- Log into Ship-It.
- Click New Release.
- Complete as follows and click Create Release:
- Please note: Revision should be the tip. The Partial updates field is automatic.
- Click Submit.
- Start the Desktop build from Ship-It via Promote RC.
- Click the Schedule button.
- Confirm Desktop build has started.
- Taskcluster email: “[desktop] Build of firefox xx.0 build 1”
- Set up Firefox Android (AC, Fenix, Focus) release in Ship-It.
- Follow the same steps as creating a beta build.
- Start Firefox Android (AC, Fenix, Focus) release in Ship-It via Promote.
- Confirm notification sent when Firefox Android builds finish.
- Push Firefox Android (AC, Fenix, Focus) release in Ship-It via Push.
- Confirm notification sent when the Firefox Android (AC, Fenix, Focus) push finishes
- Push Desktop to Beta at 100% from Ship-It via Ship RC.
- Click the Schedule button.
- Verify that the Balrog rule changes are live.
- View the Balrog Rules for Firefox Beta.
- Verify that the Background Rate for Firefox-xx.0-build1 is 100.
- Please Note: The Fallback Mapping is the previous beta release.
- Email release-signoff with a confirmation that updates are live.
- See Example
- Verify the package in the Microsoft Store submission is the correct version.
- Please Note: The submission is automatically created as part of the RC build pipeline.
- Verify that correct package was uploaded, the version displayed in the submission matches the release version
- Submit the Desktop RC build to the Microsoft Store for review
- Please Note: The Microsoft Store review can take several days, it’s recommended to submit for review at the end of RC week. If there is a blocker found later, you can always resubmit.
- Navigate to the Microsoft Partner Center
- Select Firefox from Windows & Xbox > Overview
- Select the pending submission
- In Packages enable gradual rollout and set to 25%
- Ensure to enable the option to provide the newest package when users manually check for updates.
- In Submission Options set to Automatically Publish on the go-live date and time
- Submit to the store for review
- Please see App submissions documentation for additional information on the Microsoft Store submission process.
The following tasks need to be performed at the start of RC week (week before go-live) for iOS
Firefox/Focus/Klar iOS
- Check if there are any missing backports from the previous release.
- Ensure that any backports from the dot releases on the previous version were also backported.
- Check if there are any pending PRs for the firefox-ios release branch.
- firefox-ios
- Example Filter: is:pr is:open base:release/v115
- Sync with the iOS team for Hard Freeze.
- Ask on #firefox-ios-releases Slack channel
- See Example
- Run the Firefox:import translations (strings sync) action, set the target branch to the release branch (ex: release/v118).
- See documentation here.
- Trigger the firefox-ios SPM_Deploy_Prod_Beta bitrise build workflow for the release branch.
- Trigger the firefox-ios focus_Release bitrise build workflow for the release branch.
- Verify that Firefox iOS release is available in TestFlight.
- Verify the Focus/Klar release is available in TestFlight.
As available, the following should be monitored/performed during RC week for Desktop/Android
- Phabricator patches for remote-settings updates are generated automatically. Typically this is every Monday and Thursday. These patches must be included in release/esr uplifts.
- Monitor email notifications sent by Phabricator: “No Bug, mozilla-release repo-update HSTS HPKP remote-settings tld-suffixes”/“No Bug, mozilla-esr91 repo-update HSTS HPKP remote-settings tld-suffixes”
- Review the patch.
- Commit the patch to release/esr via the moz-phab tool
- moz-phab patch <patch id> --no-bookmark --apply-to here
- Edit the commit message to add the approval.
- Update the Weekly Digest document, as requested on #fx-weekly-digest.
- Update the Release Milestones (Details) section to add Status (On Track, Delayed), Ship Date.
- Review the Release Milestones section dates and update the status.
- Verify that QA have signed off manual testing for Desktop
- QA will post a message to the #qa-coordination Slack channel when they complete update testing and another message when they complete functional testing.
- Build validation testing is tracked here
- Verify that QA have signed off update tests on Beta.
- QA will post a message to the #qa-coordination Slack channel when they complete update testing and another message when they complete functional testing.
- Verify that QA have signed off update tests on release-localtest
- QA will post a message to the #qa-coordination Slack channel when they complete update testing and another message when they complete functional testing.
- Monitor for QA sign-off on Fenix/Focus build validation before proceeding with Steps 7 to 12.
- Please Note: Build Validation sign-off is usually provided the day after Fenix/Focus builds are produced.
- Focus and Fenix QA sign-off are sent via #qa-coordination Slack Channel.
- Roll out Fenix to the Production track at 5% in google play
- See Firefox Fast & Private Browser
- Reply to the QA sign-off slack message
- “Thanks, pushed to Production at 5% rollout.”
- Roll out Focus/Klar to the Production track at 5% and Open Testing track at 100% in google play
- See Firefox Focus: No Fuss Browser and Firefox Klar Browser
- Reply to the QA sign-off slack message
- “Thanks, pushed to Production at 5% rolled out.
- Upload Fenix to Samsung Store with 5% rollout when approved
- Upload ARM32 and ARM64 APKs (armeabi-v7a/arm64-v8a)
- The APKs are available as an artifact in the signing-apk job from the Promote graph.
- Set the rollout rate to 5%
- Set to publish automatically
- Please note: It can take up to 2 days for review.
- Upload ARM32 and ARM64 APKs (armeabi-v7a/arm64-v8a)
- Upload Focus to Samsung Store with 5% rollout when approved
- Perform the same steps as Step 9
As available, the following should be monitored/performed during RC week for iOS
Focus iOS
- Monitor for QA sign-off on Focus iOS build validation before proceeding with Steps 2 and 3.
- Please Note: Build Validation sign-off is usually provided the day after the builds are produced.
- Focus iOS QA sign-off is sent via #qa-coordination Slack Channel.
- Submit iOS Focus and iOS Klar in the AppStore for review.
- Select a phased rollout when submitting.
- Select to automatically release after App Store Review on Sunday night Eastern prior to go-live (i.e. go-live date -2)
- Note: If the Monday of go-live week is a Canadian public holiday, then set the automatic release date to Monday night Eastern instead.
- Tag the release in GitHub in the firefox-ios repo using the format `focus/klar-vXXX.X`
- Wait until the Friday of RC week to avoid tagging if another RC is needed
- firefox-ios/releases
- See Example
Firefox iOS
- Monitor for QA sign-off on Firefox iOS build validation before proceeding with Steps 2 to 6.
- Please Note: Build Validation sign-off is usually provided the day after the builds are produced.
- Firefox iOS QA sign-off is sent via #qa-coordination Slack Channel.
- Add the External Beta Testers group to the Firefox Beta TestFlight Build
- Gather Firefox iOS release notes.
- This can be done in parallel to the Desktop/Android release note gathering.
- The store release notes are needed before submitting.
- Submit Firefox iOS in the AppStore for review.
- Select a phased rollout when submitting.
- Select to automatically release after App Store Review on Sunday night Eastern 10PM (Monday 2AM GMT) prior to go-live (i.e. go-live date -2)
- Note: If the Monday of go-live week is a Canadian public holiday, then set the automatic release date to Monday night Eastern instead.
- Tag the release in GitHub in the firefox-ios repo using the format `firefox-vXXX.X`
- Wait until the Friday of RC week to avoid tagging if another RC is needed
- firefox-ios/releases
- See Example
General iOS tasks
- Bump the Firefox iOS version in the release branch to XXX.1
- Wait until the Friday of RC week to avoid bumping the version if another RC is needed
RC Uplifts
This tab is for tracking bugs that are being tracked for possible uplift to the mozilla-release repository for RC builds. The primary objectives are:
- Track whether there are any drivers for a respin of the RC builds during RC week.
- Assess whether Desktop, Mobile, or both are affected by the issues noted.
- Verify that all drivers have had an explicit decision made.
The following tasks need to be performed during RC week (the week before go-live)
- Monitor Uplift Requests for Beta/Release
- For Example
- Track if there are any drivers for an RC respin during RC week.
- Assess whether Desktop, Mobile, or both are affected by the issues noted.
- Verify that all drivers have had an explicit decision made.
- If a new RC is required, for example, a release blocker was identified, then create a new RC checklist tab and perform the same steps as for the initial RC but with the following exceptions:
- Cancel the previous RC build in ship-it
- Delete the Microsoft Store submission before creating a new RC build
- Please Note: The RC build will fail if trying to create an MSIX submission when there is already a pending submission
- To cancel and delete the pending submission you may first need to change it from publishing automatically to publishing manually
- Determine if a new RC build impacts Android.
- If a new Android build is not required, then there is no impact on the Fenix/Focus builds and no action is required.
- If a new Android build is required, then repeat the RC steps with the following exceptions:
- Cancel the previous Firefox Android (AC, Focus) build in Ship-It.
- Cancel the previous Fenix build in Ship-It.
- If Fenix/Focus/Klar already rolled out - Replace the 5% rollout of Fenix/Focus/Klar in Google Play and the Samsung Store.
Go-Live Checklist
Once RC week is over and the release candidate is ready to go-live, preparations for go-live begin. After go-live, monitoring continues and if needed preparing for potential dot releases.
The following tasks need to be performed prior to go-live
- Ensure that feedback for release notes was gathered.
- Monitor the #release-notes Slack channel
- For more information on the release notes doc process see here
- Run the new-contributor.py script and add to the release notes
- For more information on the release notes doc process see here
- Release notes RelMan peer review.
- For more information on the release notes doc process see here
- Incorporate feedback into draft release notes.
- Add a release in Nucleus for Firefox, Firefox for Android, Firefox for iOS
- Duplicate the previous release, edit the version, dates, and remove the previous release notes. For example Firefox, Firefox for Android, Firefox for iOS
- Create release notes entries as outlined in the document shared on the #release-notes Slack channel
- Please Note: If images are included with the release note then create a PR for Bedrock, example PR
- Share a link to the staged release notes on #release-notes
- Ensure that Legal signoff on release notes was requested by UX/Product
- Please Note: This step is not always required, if the release notes are not atypical
- Review tracking-firefoxXX+ bugs and confirm there are no blocking issues
- Check for crash spikes with RC builds
- Schedule push to CDN from Ship-It
- Click Push
- Click Schedule
- Ensure the automated email was sent after the push to release-cdntest
- Taskcluster email: “firefox xx.0 buildx/mozilla-release has been pushed to cdntest.
- Ensure QA have performed the Update test on release-cdntest
- QA will post a message to the #qa-coordination channel in Slack when they complete update testing and another message when they complete functional testing.
- Build validation testing is tracked here
- Ensure Legal have signed off on release notes
- Please Note: This is only required based on the outcome of Step 3.
- Ensure that the security advisories are ready
- Check with the security team on the #security Slack channel
The following tasks need to be performed on go-live day
- Schedule push to release at 25% from Ship-It
- Bump Fenix rollout rate in the play store to 25%
- Bump Focus/Klar rollout rate in the play store to 25%
- Bump Fenix rollout rate in the Samsung Store to 25%
- Bump Focus rollout rate in the Samsung Store to 25%
- Ship Firefox Android (AC, Fenix, Focus) from Ship-It via Ship
- Verify that the Microsoft Store is published at 25% rollout
- Make release notes live in Nucleus
- Please Note: There is a 15-30min lag between making the change in Nucleus and the live website picking up this change, so plan to do this 15-30min prior to go-live.
- Upload security advisories to GitHub
- Signoff on scheduled rule change in Balrog
- Set the rollout percentage to 25%
- Sync with release management for another team member to signoff on the rule change.
- Send Slack message to #release-coordination to notify of the release
- For example “Firefox Desktop 115.0, ESR 115.0.0, Fenix/Focus/Klar Android 115.0, and Firefox/Focus/Klar iOS 115.0 are live”
- Include links to the release notes.
- Verify that the new release is live on mozilla.org
- Verify that the release notes are live here
- Verify LATEST_FIREFOX_VERSION in firefox_versions.json
- Verify that security advisories are live here
- Ship new Desktop release in Ubuntu Snap Store
- See Promote a snap to the stable channel for more information
- Verify that the release is live on Flathub
- The `release-flatpak-push-firefox` job runs as part of the ship graph and the publication is handled by Flathub.
- https://flathub.org/api/v1/apps/org.mozilla.firefox contains the current release available on Flathub.
- It can take up to 120 minutes for the release to publish on Flathub. If the release is not updated then reach out in the #flatpaks Matrix channel.
- Email release-drivers & release-signoff that updates are live at 25%
- Ensure QA have performed the Update tests on Release
- QA will post a message to the #qa-coordination Slack channel when they complete update testing and another message when they complete functional testing.
- Build validation testing is tracked here
- Email announce list
- Schedule Desktop update rate to 0% in Balrog after 24 hours.
- Signoff on scheduled rule change in Balrog.
- Sync with release management for another team member to signoff on the rule change.
The following tasks need to be performed 24 hours after go-live
- Verify Desktop update rate at 0% in Balrog
- Email release-signoff & release-drivers to confirm 0% throttling.
- Reply to the previous email from the go-live day.
- Example Email
The following tasks need to be performed 48 hours after go-live
- Review release crash rates and incoming bugs for new blockers.
- Bump Desktop update rate to 100% in Balrog.
- Signoff on scheduled rule change in Balrog.
- Sync with release management for another team member to signoff on the rule change.
- Bump the Microsoft Store rollout to 100%.
- Click Finalize package rollout
- Review fenix/focus release crash rates, incoming bugs for new blockers, and spike/trend in negative play store reviews.
- Check to see if there is anything concerning that would prevent completing the rollout.
- Bump fenix/focus/klar rollout rate in the play store to 100%.
- Bump fenix/focus rollout rate in the Samsung Store to 100%.
- Email release-signoff & release-drivers to confirm full rollout.
- Reply to the previous email from the go-live day.
- Example Email
The following tasks need to be performed daily after go-live
- Review release crash rates and incoming bugs for new blockers
- Review uplift requests for dot release drivers and ride alongs
The following tasks need to be weekly after go-live
- Update the Weekly Digest document, as requested on #fx-weekly-digest.
- Update the Release Milestones (Details) section to add status on the release, dot release, etc.
Dot Release Uplifts
Similar to the RC Uplifts tab. The primary purpose of this tab is to track any bugs driving a dot release and bugs that are under consideration to ride-along, It is also used to assess which products are affected by any drivers. It is up to the release manager what should go into a dot release, and we try to keep these uplift guidelines in mind. Adding even what looks like a trivial fix can add risk, both to the process (delay, extra testing, work for other teams) and to causing new regressions. For security issues, we may not want to take them in a dot release unless there is particular pressure to do so.
The following information needs to be added for each bug:
- Bug number
- Component
- Is the bug a dot release driver?
- Does the patch affect Desktop, Mobile, or both?
- Is the fix ready?
- Is the patch on mozilla-central?
- Is there an uplift request on the ticket?
- Is the uplift approved?
- Is the patch uplifted to release?
- Does the bug need a release note?
- Any additional notes
- For example, outline why the bug is being taken in a dot release.
Please Note: For each dot release, create a section in the Dot Release Uplifts tab to track the bugs in consideration: For example, “Desktop 101.0.1& Fenix/Focus 101.2.0 - GTB 2022-06-08”
Dot Release Checklist
The following tasks need to be performed at the start of preparing a dot release
- Duplicate the Desktop Dot Release Checklist tab and name it appropriately.
- Example: Desktop 101.0.1
- Email release-drivers group to inform them a dot release is being created. #* Include information on the driver, if there will be an Android release, and a link to the sheet used to track the uplifts.
- Review any pending release uplift requests
- Example Filter
- If they are low risk consider including them in the dot release
- Uplift patches to release.
- Create a release in Nucleus to add release notes
- Add a release note with a link to the major release for reference.
- For bugs that have been identified as needing a release note:
- If a release note is required and the release note text is clear from the bug content then create it directly in Nucleus.
- Otherwise, request wording before adding the release note.
- Follow the same process as creating an RC build
- If any uplifts impact mobile
- Duplicate the Mobile Dot Release Checklist tab and name it appropriately.
- If any uplifts impact mobile
- Follow the same process as reviewing an RC build has QA sign-off
The following tasks need to be performed during go-live of a dot release
- Follow the same steps as an RC go-live, with the following exceptions:
- The dot release is rolled out at 25% but there is no schedule drop to 0%
- Please Note: Under chemspill situations, a greater rollout percentage may be required.
- There may not be any security advisories.
- The dot release is rolled out at 25% but there is no schedule drop to 0%
The following tasks need to be performed 24 hours after go-live of a dot release
- Follow the same steps as after an RC go-live, with the following exceptions:
- If there are no blocking issues then bump the rollout to 100% after 24 hours
The following tasks need to be performed daily after go-live of a dot release
- Follow the same monitoring steps as after an RC go-live.